DEVICE DATASTORE

The DATASTORE device, is used to manage the reads and writesof the removable memory MMC (Multi Media Card) and in the non-removable memory (NAND) of the Qmove family instruments.

In the configuration unit, the BUS section must be declared so that you have the hardware resources required for the implementation of the DATASTORE device.

;---------------------------------
; Internal device declaration
;---------------------------------
INTDEVICE
<device name>    DATASTORE          TCamp          <port_type>

where:

;--------------------------------
; Internal device declaration
;--------------------------------
INTDEVICE
DEV        DATASTORE        0001        0

The access to MMC storage device, it is implemented through a “file_system” and not with direct access. In this way the saved data can be shared with any PC and the device is seen by it as a simple floppy disk.

File system features The file system supports the following types of FAT:
FAT12 Used on floppy disks or storage devices with limited capacity.
FAT16 Used in most storage devices. It can get to store 2 GB of data.
FAT32 Used in high-capacity storage devices, over 2 GB.

The file-system implemented, allows access to the file for reading and writing. Does not allow you to create directories, and then those files must be present in the single “root directory” . The device is also able to open/create files whose names or ASCII conversion of a number and the extension is fixed.

Supports two types of files:

• BINARY format: the file is written directly as if it were an array of long (“.hex” extension);
• CSV format (Comma Separated Values): data is written to a table with a number of columns can be set. The data are separated by “;” or is on a maximum number of characters for any data (fixed number).

Supported file formats are the BINART and the CSV. In our implementation are available the reading and appending functions (writing to END file), but not overwrite function on all types of files.

BINARY format The binary files have “hex” extension. In our implementation you can write and read a binary file where data values are stored in long (32bits) in hexadecimal base (HEX). To write or read such a file you must set the parameter filetype = 0.

If in the olongXX variables we have the following values:

olong01 = 0 => H'00000000
olong02 = -1 => H'FFFFFFFF
olong03 = 10000 => H'00002710
olong04 = -10000 => H'FFFFD8F0

We run the WRITE command by setting the parameter “field = 4”, we get to the end of the file:

00000000FFFFFFFF00002710FFFFD8F0''

CSV format The csv file will have “csv” extension. Data written in these files are organized in a table formed from a settable number of columns, each column is called a “field”. The rows of the table are called “record”. The DATASTORE device does not consider the presence of the record header. The maximum number of field is set to 32 (ilong / olong).

To write some long data type, “10000”, “-1”, “2147483647” and “-2147483648”, by setting the “filetype = 1” parameter, we will have:
The file system supports the following types of FAT:

Field1------------ +Field2--------- +Field3-------- +Field4-----+
10000              -1               2147483647      '2000000000

In this way the occupation of space in each record is fixed. If we set instead “filetype = 3”, we will have:

10000;-1;2147483647;'2000000000

The major evaluation software including Microsoft Excel, OpenOffice, Lotus 123, successfully read the fixed width file (filetype = 1) but when you save it into file with the field delimiters (filetype = 3).
The main difference between a format and the other is in the search of records.
Read a particular record using the format 1, It is not difficult as the start position within the file can be calculated easily given the record length is fixed.
Read instead a record with the format 2, implies a search within the file record start position. This operation may be long.

To use the (MMC) storage device You must use the device command that allows to recognize it and activate it. The MOUNT command allow to execute this operationn. The device will be activated when the state st_mount take the value 1.
Please note that after each command, the device marks is handling that command with the st_busy state. When the st_busy state is to 1 the device cannot access other commands.
To open an existing file or open a new file, set the filetype parameter. It allows you to specify the format of the file you intend to treat.
Below we will divide the discussion on whether the filetype parameter takes the following values:
a) 0: binary files;
b) 1-2: CSV file with fixed space for data;
c) 3-4: CSV file with data separated by “;”.
Before sending the command of opening the file you have to specify which file is open with the filenuum parameter.
If the file is present in the storage device it is open otherwise it creates a new file with the name specified in filenum file.
When the st_openfile state is to 1 the file is opened.

a) In the binary files data is present one after the other. It's possible:

• Add a data in queued;
• overwrite a given already in the list (knowing the location).

To read one or more data to a binary file, you must set the record parameter what data you begin reading and in the filed parameter how much data to read up to 32 data with one reading. At this point you have to use the READ command.
Data read are shown in the ilong01÷ ilong32 parameters.

Reading of 3 data in the position 11, 12, 13 in the binary file.

DEV:record=11
DEV:field=3
READ DEV
WAIT NOT DEV: st_busy
glVar1=DEV: ilong01
glVar2=DEV: ilong02
glVar3=DEV: ilong03

To write one or more data to a binary file you must set therecord parameter what data start overwrite and in the field parameter how much data will overwrite.
Data values by overwriting the data in the file should be inserted into olong01÷ olong32 parameters.

Writing of 3 datas int the position 11, 12, 13 in the binary file.

DEV:record=11
DEV:field=3
DEV:olong01=123        ;first data
DEV:olong02=456        ;second data
DEV:olong03=789        ;third data
WRITE DEV
WAIT NOT DEV: st_busy

To append new data to a binary file, you must use the method described above remembering to set the record parameter to -1.

B) In the CSV files with fixed datas space, is creates a table with columns, called field, and rows, called record. The field numbers with which to create the table you must specify before you open the new file in the field parameter.
For each entry in this table is reserved a fixed space. In this way each record, composed of a number field of data, fixed space in file.
To read a record of such a file, you must set in the record parameter, the number of records to read and send the READ command. In the ilong01-ilong32 parameters, are shows the read values from the record.

To overwrite a record of such a file, set the parameter records the number of records to write, set in the olong01-olong32 paramenters a number of values equal to the number of field in the record and then send the WRITE command.
To append a new record to the file you must set the value -1 in record.

Read of the record 3 (Composed of three field):

DEV:record = 3
READ DEV
glVar1 = DEV:ilong01
glVar2 = DEV:ilong02
glVar3 = DEV:ilong03

C) As in the case B, but in this case you cannot read or overwriting a particular record. You can only read sequentially around the file and write just by adding a new record.

Summary table:

* = READ sequential records: reading of records in file starting from the first record to the last. This kind of reading does not provide the ability to read records in random order within the file. This kind of reading are only going to read records from the first and reading always following the last read.
* * = READ indexed records: This kind of reading can read any record in the file even in random order.

The name of the parameter, state or command is shows at the left of the table.

R
Indicates if the parameter or state is retentive (upon initialization of the device maintains the previously defined state), or the state assumes upon initialization of the device.
If the device does not need to initialize the “R” field indicates the value that the parameter take to power up of the card.
R = Retentive
0 = Upon initialization of the device the value is forced to zero.
1 = Upon initialization of the device the value is forced to one.
- = Upon initialization of the device is presented significant value.

D
Indicates the paramenter size.
F = Flag
B = Byte
W = Word
L = Long
S = Single Float

Are describe all conditions that must exist is considered correct or because the command is accepted.
In some cases, limit values are specified for the acceptance of the parameter: If there are any values outside the limits set, the data is in any case accepted; ptherefore appropriate controls of the application must be provided to ensure the proper functioning.
To run a command, all the conditions must be met; otherwise the command is not sent.

A
Indicates the access mode.
R = Read.
W = Write.
RW,= Read / Write.

Di seguito sono presentati i parametri, variabili, stati e comandi necessari all’esecuzione del device.

I dati tipo SINGLE non sono trattati. È necessario convertire questi dati di tipo interno prima di trasferirli nella MMC.

WAIT NOT DEV:st_busy               ; necessaria perché il device alla momento del RUN
                                   ; è in uno stato di busy finchè non termina
                                   ; le operazioni di inizializzazione.
MOUNT DEV                          ; esegue il MOUNT del dispositivo
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_mount                    ; se il dispositivo è presente,
  <operazioni>                     ;lo stato st_mount è 1
ENDIF

DEV:filetype = 0                   ; imposta il tipo di file BINARY
DEV:filenum = 123                  ; imposta il nome del file come “123.hex”
WAIT NOT DEV:st_busy
OPENFILE DEV                       ; esegui il comando di apertura
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_openfile                 ; se il file viene aperto correttamente,
  <operazioni>                     ;lo stato st_openfile è 1
ENDIF

DEV:field = 2                      ; imposta il numero di campi di cui
                                   ; è composto il record
                                   ; Nota: se il tipo di file è BINARY,
                                   ; questo parametro indica il numero di long
                                   ; che verranno scritte/lette.
DEV:record = -1                    ; indica al device di eseguire l’operazione a
                                   ; partire dalla fine del file (accodamento).
DEV:olong01 = 123456               ; imposta il dato da scrivere
DEV:olong02 = 654321
WAIT NOT DEV:st_busy
WRITE DEV                          ; esegui il comando di scrittura
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_error                    ; verifica se ci sono stati errori in scrittura
  <errore>
ENDIF